css-overview: Elaborate how color expressions work

diff --git a/docs/reference/gtk/css-overview.xml b/docs/reference/gtk/css-overview.xml
index d5e6cf2cf36bd9f446218fb2ec392ae03594cc67..3a7925e2b5fa2224b83e027a8f7ffbb89408837f 100644 (file)
--- a/docs/reference/gtk/css-overview.xml
+++ b/docs/reference/gtk/css-overview.xml
@@ -582,9 +582,14 @@ background-color: @bg_color;
     </example>
 
     <para>
-      GTK+ also allows to form color expressions, which can be nested and
-      provide a rich language to define colors which are derived from a
-      set of base colors.
+      GTK+ also supports color expressions, which allow colors to be transformed
+      to new ones and can be nested, providing a rich language to define colors.
+    </para>
+    <para>
+      Color expressions resemble functions, taking 1 or more colors and in some
+      cases a number as their arguments. The number is floating-point, clamped
+      between 0 and 1, and specifies the degree to which the expression will
+      transform the given color(s) in the manner that is indicated by its name.
     </para>
 
 <literallayout><code>〈color expression〉 = lighter(〈color〉) | darker(〈color〉) | shade(〈color〉,〈number〉) | alpha(〈color〉,〈number〉) | mix(〈color〉,〈color〉,〈number〉)</code>